)

## Summary

Extend `generate-docs-sections.ts` with 7 new marker-based sections that
eliminate documentation drift by auto-generating content from source
code. Also adds missing `SENTRY_RELEASE` to the env var registry and
hand-written examples for `release delete`/`deploys` and `event list`.

Supersedes #851 with structural automation instead of manual patching
(same relationship as #739 → #724).

## What's auto-generated now

| Section | File | Source of Truth |
|---------|------|----------------|
| Dev prerequisites | `README.md`, `contributing.md` | `packageManager`
in `package.json` |
| Library prerequisites | `README.md` | `engines.node` in `package.json`
|
| Dev scripts | `README.md` | Curated subset (descriptions aren't
machine-readable) |
| Dev env var table | `DEVELOPMENT.md` | `env-registry.ts` entries with
`devGuide` tag |
| Self-hosted env var table | `self-hosted.md` | `env-registry.ts`
entries with `selfHosted` tag |
| Platform support | `getting-started.mdx` | Static data matching
`ALL_TARGETS` in `build.ts` |
| *(existing)* Project structure | `contributing.md` | Route tree
introspection |
| *(existing)* OAuth scopes | `DEVELOPMENT.md`, `self-hosted.md` |
`OAUTH_SCOPES` array |

## What was wrong with #851

1. **`SENTRY_CUSTOM_HEADERS` format was documented as comma-separated
`key:value`** — the actual code (`src/lib/custom-headers.ts`) uses
**semicolon-separated `Name: Value` pairs**. Would have shipped
incorrect docs.
2. **Manual fixes to driftable content** — version numbers, env var
tables, and platform support will go stale again. This PR generates them
from source code instead.
3. **Committed `DOCUMENTATION_AUDIT.md` at repo root** — a 162-line
audit report that becomes stale immediately.
4. **Manually edited skill files** — these are auto-generated from
fragments; editing them directly means the next `generate:docs`
overwrites the manual changes.

## Changes

### Source-of-truth additions
- `SENTRY_RELEASE` added to `env-registry.ts` (flows into auto-generated
`configuration.md`)
- `selfHosted` and `devGuide` tags added to `EnvVarEntry` type and
relevant entries

### Generator extensions (`script/generate-docs-sections.ts`)
- MDX marker support (`{/* GENERATED:START */}` syntax for `.mdx` files)
- `dev-prereq`: Bun version from `packageManager` field
- `library-prereq`: Node version from `engines.node`
- `dev-scripts`: Curated script list with descriptions
- `dev-env-vars`: Table from registry entries tagged `devGuide`
- `self-hosted-env-vars`: Table from entries tagged `selfHosted`, with
cross-validation
- `platform-support`: Platform/architecture table

### Fragment additions (hand-written, as designed)
- `release.md`: Examples for `release delete` (with `--yes`,
`--dry-run`) and `release deploys`
- `event.md`: Full "Listing Events" section with query, full, period,
pagination, JSON examples

### CI
- `README.md` and `getting-started.mdx` added to `check-generated`
git-diff and auto-commit lists